bgdelivery proc returnfile (public)

 bgdelivery[i] returnfile [ -client_data client_data ] [ -delete delete ] \
    [ -content_disposition content_disposition ] status_code mime_type \
    filename

Defined in packages/xotcl-core/tcl/bgdelivery-procs.tcl

Deliver the given file to the requester in the background. This proc uses the background delivery thread to send the file in an event-driven manner without blocking a request thread. This is especially important when large files are requested over slow connections. With NaviServer, this function is mostly obsolete, at least, when writer threads are configured. The writer threads have as well the advantage, that these can be used with https, while the bgdelivery thread works directly on the socket. One remaining purpose of this function is h264 streaming delivery (when the module is in use).

Switches:
-client_data
(optional)
-delete
(defaults to "false") (optional)
-content_disposition
(optional)
Parameters:
status_code
mime_type
filename

Partial Call Graph (max 5 caller/called nodes):
%3 ad_conn ad_conn (public) ad_file ad_file (public) security::secure_conn_p security::secure_conn_p (public) thread::transfer thread::transfer xo::backslash_escape xo::backslash_escape bgdelivery proc returnfile bgdelivery proc returnfile bgdelivery proc returnfile->ad_conn bgdelivery proc returnfile->ad_file bgdelivery proc returnfile->security::secure_conn_p bgdelivery proc returnfile->thread::transfer bgdelivery proc returnfile->xo::backslash_escape

Testcases:
No testcase defined.
[ show source ]
Show another procedure: